Description of Keys & Commands
==============================
Note: English translation still under construction!

Command-Group "CLIP": Zwischenablage
====================================

RK bietet eine Reihe von Commands, die den Inhalt der Zwischenablage
manipulieren.
Die Zwischenablage wird in diesem Kapitel kurz "Clip" genannt.


/CLIP.CALC [mod] ......: To calculate clip content (if in form of a list), <mod>=1: average calculation
------------------------
Wenn Zahlen in der Zwablage in Listenform vorliegen, kann dieser Command das Ergebnis
berechnen. I.d.R wird es sich um Addition und Subtraktion handeln, mglich sind aber auch
Multiplikation (*) und Division (/) und Prozent (% - mu am Zeilenende stehen).
Theoretisch mglich ist auch Potenzierung (^), Wurzel (v) und 1/x Berchnung (\).
Ist kein Operator angegeben, so wird Addition vorausgesetzt.
Kommas werden in erforderliche Punkte gewandelt, nur fr die Ausgabe wird das Komma, sofern
in den Lndereinstellungen von Windows eingestellt, wieder ausgegeben.
Ab v7.7.61 ist ClipCalc ein eigenstndiges Programm und gestattet den Parameter <mod>=1, der
eine Durchschnitts-Berechnung durchfhrt.

Example:
Generate a button with following content:

{/BTCH.EXPLICIT}
{/CLIP.CALC}
{/CLIP.TXT.VIEW}

Now copy following block into the clipboard

 44.50
 17.33
112.05

and click on the new generated RK button.

--> Tip
This will also work, if a column in Excel is copied into the clip.

--> Note
The result has been automatical stored in the current VAR for additional calculations.

--> Note
The profile "Script-Calculator" based on this principle so it is possible to code a
complete calculator with the RK script language.


/CLIP.CLEAR ...........: To clear the clipboard
------------------------

Example: {/CLIP.CLEAR}


/CLIP.COPYPATH ........: To copy a path into the clipboard
------------------------

Example: {/CLIP.COPYPATH}


/CLIP.IMG.LOAD file....: To copy the image <file> into the clipboard
------------------------
Mittels diesem Command kann man ein Bild (bmp, jpg, gif) ins Clip einlesen,
das dann anschlieend zwecks Einfgen in eine Anwendung zur Verfgung steht.

Example: {/CLIP.IMG.LOAD c:\work\myface.jpg}


/CLIP.IMG.VIEW ........: To show the image, copied in the clipboard, in the internal image viewer
------------------------

Example: {/CLIP.IMG.VIEW}


/CLIP.IMG.MEM no ......: To load the pic <no> (1-10) from the Image Memory into the clipboard
------------------------
Die Funktion "Speicher fr Bilder" (bitte dort nachlesen) kann bekanntlich 10
Bilder beherbergen. Dieser Command gestattet es, eines der 10 Bilder dieser
Funktion ins Clip einzulesen.

Example: {/CLIP.IMG.MEM 10}


/CLIP.TXT.APPEND file .: To add clipboard included text to textfile <file>
------------------------

Example: {/CLIP.TXT.APPEND c:\test.txt}


/CLIP.TXT.ASK .........: To copy a text into clipboard, defined from user during script is in process
------------------------

Example: {/CLIP.TXT.ASK}

--> Tip
Wird der Dialog durch "Abbrechen" geschlossen, so kann die Skript-Abarbeitung
an dieser Stelle durch den Commands "BTCH.EXIT-ON-CANCEL" (siehe dort) beendet
werden.


/CLIP.TXT.BEFOR txt....: To add a text <txt> at the beginning of the clipboard
/CLIP.TXT.BEHND txt....: To add a text <txt> to the end of the clipboard
------------------------
Mit diesen Commands kann man nicht nur den Inhalt des Clips mit Text erweitern,
sondern auch einen Text ins Clip kopieren, soda der bisherige Inhalt komplett
ersetzt wird.

Example: {/CLIP.CLEAR}{/CLIP.TXT.BEFOR Text-Beispiel}

In diesem Beispiel steht nur noch der Text "Text-Beispiel" im Clip.

Example:
{/CLIP.TXT.BEFOR Zeile1
Zeile2}

Zeilenumbrche, wie in diesem Beispiel, sind auch mglich.


/CLIP.TXT.BEHND.ASC [no] To add an ASCII code <no> to the end of the clipboard (default VAR)
/CLIP.TXT.BEHND.ASK ...: To add a text to clipboard, defined from user while script is in process
/CLIP.TXT.BEHND.CR ....: To add a Carriage Return (new line) to the end of the clipboard
/CLIP.TXT.BEHND.MEM ...: To add RK-ClipMemory to the end of the clipboard
/CLIP.TXT.BEHND.STR [n]: To add variable STR <n> to the end of the clipboard (default VAR)
/CLIP.TXT.BEHND.VAR ...: To add the current variable VAR to the end of the clipboard
------------------------

--> Tip
Mit dem -.ASC Command lt sich eine Konvertierung von einem Wert in ein Zeichen vornehmen.
In Basic wrde die Formel theoretisch so aussehen:
clip=clip+CHR$(VAR).
Dies erreicht man, indem man der VAR einen Wert zuweist und den Parameter [no] einfach weglt.

Example:

{/BTCH.EXPLICIT}
{/VAR.SET 65}
{/CLIP.CLEAR}
{/CLIP.TXT.BEHND.ASC}
{/CLIP.TXT.SEND}

In diesem Beispiel wird der Buchstabe "A" ausgegeben, da er dem ASCII-Code 65 entspricht.


/CLIP.TXT.BLOCK.BEGIN .: To mark the beginning of a script-block which will be copied into the clip
/CLIP.TXT.BLOCK.END ...: To mark the end of the block for CLIP.TXT.BLOCK.BEGIN (optional, otherwise text-end)
------------------------
Diese Commands gestatten es, einen Textblock im Skript in die Zwischenablage zu kopieren.
Der BLOCK.END-Command ist nicht zwingend erforderlich. Fehlt er, so wird automatisch
das Skript-Ende als Block-Ende gesetzt.

Beispiel:
{/CLIP.TXT.BLOCK.BEGIN}
Zeile 1
Zeile 2

Beispiel:
{/CLIP.TXT.BLOCK.BEGIN}
Zeile 1 und
Zeile 2 kommen aus dem Clip,{/CLIP.TXT.BLOCK.END}
{/BTCH.EXPLICIT}
{HOLD.CONTROL}v
{KEY.ENTER}
Zeile 3 wird gesendet.

-> Beachte!
Ein vorangestellter BTCH.EXPLICIT-Command fhrt sicher zu ungewollten Ergebnissen,
da er die CRs aus dem Skript entfernt.

-> Tip
Diese Command-Kombination kann auch dazu verwendet werden, einen Block innerhalb
eines Skriptes zu markieren, der nicht gesendet werden soll.

Example:

Diese Zeile wird gesendet.
{/CLIP.TXT.BLOCK.BEGIN}
Diese Zeile wird nicht gesendet
{/CLIP.TXT.BLOCK.END}Diese Zeile wird wieder gesendet.

Optisch wre es sicher schner, vor der 3. Zeile einen Zeilenumbruch zu machen,
dadurch wrde aber ein vermutlich ungewollter Carriage Return (CR) gesendet werden.
Bitte bedenken, da dadurch die Zwischenablage neu beschrieben wird.


/CLIP.TXT.CONV [mod] ..: To convert val/txt in clip, <mod>=0: dec>hex, <mod>=1: hex>dec (default 0)
------------------------

Example: {/CLIP.TXT.CONV 0}

Steht in der Zwablage die Zahl 234, so steht nach Aufruf dieser Funktion der Text "EA" dort.
Da Modus "0" der Vorgabewert ist, htte es auch der Command {/CLIP.TXT.CONV} getan.


/CLIP.TXT.COUNT .......: To count the clipboard included characters
-------------------------
In vielen Internet-Formularen ist die Eingabe auf eine bestimmte Anzahl von
Zeichen beschrnkt. Wenn Texte fr unterschiedliche Formulare vorverfat
werden, ist es sehr hilfreich, die Zeichenanzahl dieser Texte schnell zu
ermitteln: Einfach ins Clip kopieren und diesen Command aufrufen.

Example: {/CLIP.TXT.COUNT}


/CLIP.TXT.CUT.LEFT [qu]: To remove <qu> (quantity) characters from left (default VAR) (-qu=len-qu)
/CLIP.TXT.CUT.RGHT [qu]: To remove <qu> (quantity) characters from right (default VAR) (-qu=len-qu)
/CLIP.TXT.CUT.FROM [pos] To remove text right from character no. <pos> (position) (default VAR) (-qu=len-qu)
/CLIP.TXT.CUT.REVERSE .: To swap between clip and reversal of last .CUT. command
------------------------
This is a kind of basic Left$() and Right$() commands.
Mid$() can be realized if Left$() is used before.
If <qu> or <pos> are not set, the value of current VAL will be taken instead.


Example:

{/BTCH.EXPLICIT}        ; unterdrckt CR (also erlaubt Zeilenumbrche wie hier)
{/STR.SET 1,1234567890} ; weist STR1 den Text "1234567890" zu
{/STR.CLIP.SET 1}       ; kopiert STR 1 in die Zwablage
{/CLIP.TXT.CUT.LEFT 3}  ; Schneidet 3 Zeichen links ab (123 geht weg)
{/CLIP.TXT.CUT.FROM 5}  ; Schneidet alles ab Pos. 5 ab (inkl. dem 5. Zeichen)
{/STR.CLIP.GET 1}       ; schreibt die Zwablage wieder in STR1 zurck
{/STR.VIEW}             ; zeigt (u.a.) STR1 an

The Viewer will show the content "4567" for STR 1.

Ab v8.0 ist ein negativer qu-Parameter mglich. In diesem Fall berechnet sich qu neu aus der
Differenz zwischen der Gesamtlnge der Zwablage und qu.
Das bedeutet: Stehen 10 Zeichen in der Zwablage und es wird der Parameter -3 angegeben, so
wird aus qu nun 7.

Der ebenfalls ab v8.0 zur Verfgung stehende REVERSE-Command wechselt zwischen dem durch einen
CUT-Command erzeugten abgeschnittenen Teil und dem daraus resultierenden gelschten Teil der Zwablage.
Ohne einem vorangegagenen CUT-Command hat dieser Command also keine Wirkung.
Beispiel: In der Zwablage steht "1234567890". Nun werden mittels des CUT.LEFT-Commands die ersten 4
Zeichen gelscht. In der Zwablage steht nun "567890". Wird nun der REVERSE-Commd aufgefhrt, so
ndert sich der Inhalt der Zwablage in "1234"; also in den zuvor gelschten Teil.
Erneutes Ausfhren des Commands stellt den Urzustand wieder her, weswegen er eigentlich "REVERSE.SWAP"
heien mte, aufgrund der Lnge aber darauf verzichtet wurde.


/CLIP.TXT.ENCRYPT .....: To encrypt the clipboard included text
/CLIP.TXT.DECRYPT .....: To decrypt the clipboard included text
------------------------
Die Crypt-Funktion wurde zum verschlsseln von Skript-Inhalten in RK
implementiert (s. "Verschlsselt"-Checkbox in "Bearbeiten > Knpfe").
Da diese Module nun schonmal vorhanden waren, war es wenig Aufwand, sie
fr das Ver- und Entschlsseln von Texten im Clip bereitzustellen.
Mchte man einen ASCII-Text verschlsselt auf HD ablegen, so kopiert man
ihn ins Clip, verschlsselt ihn unter Eingabe eines Pawortes (= Kodierungs-
schlssel, wird von RK automatisch abgefragt), und fgt ihn anschlieend
verschlsselt in die Anwendung zurck.
Nun kann man den Text abspeichern.
Mchte man ihn wieder lesbar machen, kopiert man ihn abermals ins Clip,
endschlsselt ihn unter Eingabe des selben Pawortes und kopiert ihn in
eine Text-Anwendung.
Achtung, bei Verlust des Pawortes scheint es unmglich, den Text jemals
wieder lesbar zu machen!

Example: {/CLIP.TXT.ENCRYPT}


/CLIP.TXT.EDITOR ......: To open clipboard content in the editor
------------------------

Example: {/CLIP.TXT.EDITOR}


/CLIP.TXT.END>FRONT [s]: Setzt das durch Leerzeichen getrennte Ende nach vorn, optional mit Trennzeichen <s>
/CLIP.TXT.FRONT>END [s]: Setzt den durch Leerzeichen getrennten Anfang nach hinden, opt. mit Trennz <s>
------------------------
Diese Commands sind z.B. in der Lage, in der Zwablage befindliche Namens-Listen zu drehen.

Beispiel

Liza Minelli
Johann Sebastian Bach

wird zu

Minelli, Liza
Bach, Johann Sebastian

und bei Bedarf zurck in den Ursprung.

Die dazugehrigen Skripts sehen so aus:

{/BTCH.EXPLICIT}          ; Listen-Darstellung fr dieses Skript gestatten
{/CLIP.TXT.END>FRONT ,}   ; Letztes Wort nach vorn stellen, durch Komma getrennt
{/CLIP.TXT.BEHND.CR}      ; Am Ende der Zwablage neue Zeile ffnen
{/CLIP.TXT.SEND}          ; Zwablage senden

und

{/BTCH.EXPLICIT}
{/CLIP.TXT.REMOVE.TXT ,}  ; Smtliche Kommas in der Zwablage entfernen
{/CLIP.TXT.FRONT>END}     ; Erste Wort nach hinten stellen
{/CLIP.TXT.BEHND.CR}
{/CLIP.TXT.SEND}

--> Beachte!
Nochmals, damit es deutlich wird:
Es knnen sowohl einzelne Namen, als auch ganze Namens-Listen in einem Durchgang gedreht werden.

--> Tip!
Stellt man vor die Wandlung den Command {/CLIP.TXT.TAB>SPC 1}, so lassen sich auch aus
Excel kopierte Spalten umstellen.


/CLIP.TXT.FORMAT.DO ...: To format calculation list in clipboard
/CLIP.TXT.FORMAT.SET [n] To define format mode, <n> (-1,0,1,2,3...) : -1=off, 0=flash, 2= 0.00 etc.
/CLIP.TXT.FORMAT.SYM txt To add currency symbols, <txt> for $ etc, off=off, del=delete current symbols
------------------------
Diese Commands wurden fr die formatierte Ausgabe des Script-Calculator-Profils entwickelt.
Falls man das dort im ClipMonMini (CMM) sichtbare Ergebnis anderwrtig gebrauchen kann,
steht der Benutzung dieser Commands natrlich nichts entgegen. 

Sample-Script:

{/BTCH.EXPLICIT}
{/APP.ACTIVATION.OFF}
{/CLIP.TXT.FORMAT.SYM del} ; lscht event. vorhandene Symbole
{/CLIP.TXT.FORMAT.SET 2}   ; schaltet auf Format #.00
{/CLIP.TXT.FORMAT.DO}      ; formatiert die Ausgabe
{/CLIP.TXT.FORMAT.SYM EUR} ; definiert EUR als Whrungs-Symbol
{/CLIP.TXT.FORMAT.DO}      ; formatiert die Ausgabe


/CLIP.TXT.INITIAL [str]: To convert first letter after space, TAB & CR into upper case, opt. more chars <str>
------------------------

Example: {/CLIP.TXT.INITIAL}

Aus dem Satz "abc def, ghi" wird "Abc Def, Ghi".

Ab v8.2 kann optional ein Zeichenketten-Parameter angegeben werden, der weitere
Zeichen auer Leerz, TAB & CR bercksichtigt.
Ohne Parameter macht der Command aus "hans-peter" > "Hans-peter", da der
Bindestrich unbercksichtigt bleibt.
Um "Hans-Peter" zu erzeugen sieht der Command so aus: {/CLIP.TXT.INITIAL -}.
Man kann beliebig viele Zeichen hinzugeben, z.B. {/CLIP.TXT.INITIAL -.,}.


/CLIP.TXT.LOAD file....: To load the textfile <file> into the clipboard
------------------------
Mittels diesem Command kann man einen ASCII-Text ins Clip einlesen, der dann
anschlieend zwecks Einfgen in eine Anwendung zur Verfgung steht.

Example: {/CLIP.TXT.LOAD c:\docs\myhistory.txt}


/CLIP.TXT.LOWCASE .....: To convert the clipboard text to lower cases
/CLIP.TXT.UPCASE ......: To convert the clipboard text to upper cases
------------------------

Example: {/CLIP.TXT.LOWCASE}


/CLIP.TXT.MEM.COPY ....: To copy clipboard text into RK-ClipMemory
/CLIP.TXT.MEM.SWAP ....: To swap between clipboard text and RK-ClipMemory
------------------------
RK besitzt einen Speicher fr die Zwischenablage, genannt ClipMemory. Mit dem Copy-Command
wird der aktuelle Inhalt der Zwablage dort hineingeschrieben, wogegen der SWAP-Command die
Inhalte der Zwablage und des Speichers austauscht.

Example: {/CLIP.TXT.SWAP}

--> Beachte !
Nach dem ersten Aufruf ist die Zwablage natrlich leer, da der "Swap"-Speicher ja noch
unbeschrieben war.

Also folgendermaen vorgehen:
1. Text markieren und in die Zwablage kopieren
2. /CLIP.TXT.SWAP aufrufen
3. Anderen Text markieren und in die Zwablage kopieren
2. /CLIP.TXT.SWAP erneut aufrufen 

Nun stehen mittels /CLIP.TXT.SWAP 2 unterschiedliche Texte in der Zwablage zum Abruf bereit.


/CLIP.TXT.REMOVE.ASC ..: To remove the ASCII code <no> from the clipboard
/CLIP.TXT.REPLACE.ASC .: To replace the first ASCII code with the second <no>,<no>
------------------------

Example: {/CLIP.TXT.REMOVE.ASC 34}

In diesem Beispiel werden smtliche Anfhrungszeichen im Clip gelscht.

Example: {/CLIP.TXT.REPLACE.ASC 45,61}

In diesem Beispiel werden smtliche Bindestriche im Clip durch Gleichheits-
zeichen ersetzt.

Im App-Ordner des RK-Ordners befindet sich das Tool "CheckASC", mit dessen Hilfe
man die ASCII-Codes fr die Zeichen ermitteln kann.


/CLIP.TXT.REMOVE.ASK ..: To remove a define-able character or text
/CLIP.TXT.REPLACE.ASK .: To replace a define-able character or text
------------------------
Diese beiden Commands ffnen ein Dialog-Fenster, indem die gewnschten nderungen
vorgenommen werden knnen.
Nhere Hinweise findet man auch im Manual-Text "Clip History".

Example: {/CLIP.TXT.REMOVE.ASK}
Example: {/CLIP.TXT.REPLACE.ASK}


/CLIP.TXT.REMOVE.TXT ..: To remove the text <txt> from the clipboard
/CLIP.TXT.REPLACE.TXT .: To replace first text with the second <txt>,<txt>
------------------------

Example: {/CLIP.TXT.REMOVE.TXT anm.: }

In diesem Beispiel werden nicht nur die Texte "anm.: " aus der Zwablage entfernt, sondern auch
z.B. "Anm.: ".

Example: {/CLIP.TXT.REPLACE.TXT beispiel,Example}

Dieses Beispiel ersetzt alle "Beispiel" durch "Example".


/CLIP.TXT.SAVE file ...: To save clipboard included text in textfile <file>
------------------------
Diesen Command kann man auch nutzen, um den Inhalt einer Textdatei in Zusammenwirken
mit /CLIP.CLEAR zu lschen, um sie z.B. fr /CLIP.TXT.APPEND vorzubereiten.

Example: {/CLIP.TXT.SAVE c:\test.txt}


/CLIP.TXT.SEND ........: To send the clipboard included ASCII text
------------------------
Dies funktioniert hnlich dem Windows-Einfgen per [Strg]+[v], allerdings sendet
der Command den Text auch, wenn die Windows-Einfge-Option ungeeignet erscheint.

Example: {/CLIP.TXT.SEND}


/CLIP.TXT.SET txt .....: To copy text a <txt> into the clipboard
------------------------

Example: {/CLIP.TXT.SET http://www.freewarehits.de}


/CLIP.TXT.TAB>SPC no ..: To convert tabs to <no> spaces in the clipboard
------------------------

Example: {/CLIP.TXT.TAB>SPC 8}


/CLIP.TXT.TRIM ........: To cut spaces and CR from beginning and end of the clipboard text
------------------------
Dieser Command kann recht ntzlich sein, wenn etwas ungnstig formatiertes in
das Clip kopiert wurde, wie es z.B. oft bei Webseiten der Fall ist.

Example: {/CLIP.TXT.TRIM}

--> Tip
Zum Korrigieren von schlecht formatieren Text aus Webseiten steht auf
freewarehits.de die Freeware-Tools "Copy & Trim" und "ClipEd" als Bestandteile des
"ToolsPackage" zum Download bereit.


/CLIP.TXT.VIEW ........: To show the clipboard content (text only) in the internal text viewer
------------------------

Example: {/CLIP.TXT.VIEW}